重要:
このテクニカルノートは次のネットワーキングAPIに焦点を絞っています。

• Mac OS XのBSDソケットAPI
• Mac OS XのOpen Transportコンパティビリティライブラリ
• 従来のMac OSのOpen Transport API（Classic環境を含む）

MacTCPまたはOpen TransportのMacTCPインタフェース等の旧いAPIは取り扱いません。MacTCPプログラミングインタフェースは、このテクニカルノートで説明するすべてのケースを処理するには不十分です。

上記ネットワーキングAPIの上に位置するハイレベルAPIについても、このテクニカルノートでは取り扱いません。URL AccessやCFNetwork等のハイレベルAPIとダイナミックTCP/IP環境の関係については各APIの技術資料をご覧下さい。

リスト1 共有ルーチン

// エラー処理
// ----------
// SCFは2つの方法でエラーを返します:
//
// o 異常を示すために、関数結果が無効な値（NULLやfalseなど）と
//   なって返ってくることがあります。
//
// o 最後に実行した関数のエラーコードを返すためのルーチン
//   （SCError）が存在します。SCErrorの返すエラー番号は
//   OSStatusの範囲外のエラー番号となります。
//
// これをMoreSCErrorとMoreSCErrorBooleanの2つの関数で処理します。
// 2つの関数は一般的なエラー値（ポインタまたはBoolean）を受けて、
// エラーを示す内容であれば、SCErrorを呼び出して実際のエラー番号を
// 取得しています。同時に、SCエラー番号をOSStatusエラー番号の
// 有効範囲にマッピングするためのボトルネックの役割もはたすように。
// 設計されていますが、このサンプルではマッピングを省略しています。
//
// エラーパラメータの部分を省略して、単純にSCErrorを呼ぶことも
// 考えられますが、SCFがSCErrorを設定せずにエラーを返すことが心配
// でした。実際にそのようなことは報告例がないので余計な心配かもしれ
// ませんが、安全が第一です。

static OSStatus MoreSCErrorBoolean(Boolean success)
{
    OSStatus err;
    int scErr;

    err = noErr;
    if ( ! success ) {
        scErr = SCError();
        if (scErr == kSCStatusOK) {
            scErr = kSCStatusFailed;
        }
        // SCFエラーを直接OSStatusとして返しているが、これは真似しないで
        // 下さい。実際のプログラムでは、SCFエラー番号をOSStatusエラー番号の
        // 有効範囲にマッピングするなど、正しく対処して下さい。
        err = scErr;
    }
    return err;
}

static OSStatus MoreSCError(const void *value)
{
    return MoreSCErrorBoolean(value != NULL);
}

static OSStatus CFQError(CFTypeRef cf)
    // Core Foundationのエラー状況を（ありのままで）OSStatusドメインに
    // マッピングします。
{
    OSStatus err;

    err = noErr;
    if (cf == NULL) {
        err = coreFoundationUnknownErr;
    }
    return err;
}

static void CFQRelease(CFTypeRef cf)
    // NULLにも耐えられるCFRelease
{
    if (cf != NULL) {
        CFRelease(cf);
    }
}

重要:
従来のMac OSの場合では、マルチホーミングはあまり関係ないと思うかもしれませんが、従来のMac OSでもマルチホーミングが有効となる場合があります。

• Open Transport 1.3以降では、一つの物理インタフェースに複数のIPアドレスを設定することができます。（これをシングルリンク・マルチホーミングと呼びます。）
• サードパーティソフトウェアを使用することによって、マルチリンク・マルチホーミングを使用することができます。
• リモートアクセスのサーバが実行しているコンピュータがIPCP（PPP上のTCP/IP）経由で接続を受けると、そのコンピュータにはIPアドレスが１つ追加されます。

Mac OS Xを搭載しているコンピュータはすべてマルチホーミングをサポートします。ここに記載されている注意事項に気を付ければ、いずれのプラットフォームでもマルチホーミングをサポートすることができます。

リスト2 外部と接続する場合のコード

static OSStatus DoOutgoingBind(EndpointRef ep)
{
    OSStatus err;

    err = OTBind(ep, NULL, NULL);
    return err;
}

重要:
コンピュータの主要IPアドレスを取得して、そのアドレスにバインドすると、以下のことが言えます。

• あなたは必要以上のコードを書いています。
• マルチホーミングを使って、個別のインターネットに接続されているコンピュータの場合、あなたのコードは動作しません。
• 将来IPv6への移行の際に、変更しなければならない箇所を1つ増やしていることになります。

リスト3では接続する場合の悪い例を紹介しています。

リスト3 以下のコードは外部と接続する場合の悪い例です。

// *** このようなコードを書かないで下さい！ *** 

static OSStatus DoOutgoingBindWrongly(EndpointRef ep)
{
    OSStatus            err;
    InetInterfaceInfo   info;
    InetAddress         primaryAddr;
    TBind               bindReq;

    err = OTInetGetInterfaceInfo(&info, kDefaultInetInterface);
    if (err == noErr) {
        OTInitInetAddress(&primaryAddr, 0, info.fAddress);

        OTMemzero(&bindReq, sizeof(bindReq));
        bindReq.addr.buf = (UInt8 *) &primaryAddr;
        bindReq.addr.len = sizeof(primaryAddr);

        err = OTBind(ep, &bindReq, NULL);
    }
    return err;
}

// *** このようなコードを書かないで下さい！ *** 

リスト4 外部からの接続を受ける場合のコード（BSDソケットの場合とOpen Transportの場合）

static int DoIncomingBindBSDSockets(int sock, u_short port)
{
    int err;
    struct sockaddr_in req;

    memset(&req, 0, sizeof(req));
    req.sin_family = AF_INET;
    req.sin_addr.s_addr = htonl(INADDR_ANY);
    req.sin_port = htons(port);

    err = bind(sock, (struct sockaddr *) &req, sizeof(req));
    if (err == -1) {
        err = errno;
    }

    return err;
}

static OSStatus DoIncomingBindOT(EndpointRef ep, InetPort port)
{
    OSStatus    err;
    TBind       req;
    TBind       ret;
    InetAddress reqAddr;
    InetAddress retAddr;

    OTInitInetAddress(&reqAddr, port, kOTAnyInetAddress);

    OTMemzero(&req, sizeof(req));
    req.addr.buf    = (UInt8 *) &reqAddr;
    req.addr.len    = sizeof(reqAddr);
    req.qlen        = 10;

    OTMemzero(&ret, sizeof(ret));
    ret.addr.buf    = (UInt8 *) &retAddr;
    ret.addr.maxlen = sizeof(retAddr);

    err = OTBind(ep, &req, &ret);
    if (err == noErr) {
        if (retAddr.fPort != reqAddr.fPort) {
            (void) OTUnbind(ep);
            err = kOTAddressBusyErr;
        }
    }
    return err;
}

註:
IPアドレスによって異なる結果を返す場合はサーバのエチケットについてもお読み下さい。

リスト5 ローカルIPアドレスを取得します（BSDソケットの場合とOpen Transportの場合）

static int GetLocalIPAddressForConnectionBSDSockets(int sock,
                                    struct in_addr *localAddr)
{
    int err;
    int len;
    struct sockaddr_in local;

    len = sizeof(local);
    err = getsockname(sock, (struct sockaddr *) &local, &len);
    if (err == -1) {
        err = errno;
    }
    if (err == 0) {
        assert(len == sizeof(local));
        *localAddr = local.sin_addr;
    }

    return err;
}

static OSStatus GetLocalIPAddressForConnectionOT(EndpointRef ep,
                                         InetAddress *localAddr)
{
    OSStatus err;
    TBind localBind;

    // エンドポイントが接続済であることが前提です。
    assert(OTGetEndpointState(ep) == T_DATAXFER);
    assert(OTIsBlocking(ep));

    OTMemzero(&localBind, sizeof(TBind));
    localBind.addr.buf = (UInt8 *) localAddr;
    localBind.addr.maxlen = sizeof(InetAddress);

    err = OTGetProtAddress(ep, &localBind, NULL);
    return err;
}

註:
このルーチンではエンドポイントがT_DATAXFERステータスにあると断定しています。というのも、エンドポイントが接続されていない場合、OTGetProtAddressはエンドポイントがバインドされていたアドレスを返すだけで、これは一般に何の役にも立ちません。BSDソケットの場合は、getpeernameで同じテストが可能ですが、コードが多少複雑になります。

重要:
従来のMac OSにおけるOpen Transportアーキテクチャの制限により、上のコードによって返されるIPアドレスがすべてのIPアドレスのリストによって生成されたIPアドレスのリストに含まれていないこともあります。

重要:
一般的には、ローカルIPアドレスに依存するようなプログラム設計は避けるべきです。これまで説明したような方法で実現可能です。コンピュータのIPアドレスを取得するのは以下の場合のみでしょう。

• 外部からの接続があった時、IPアドレスによってふるまいが変わるようなサーバの場合。
• IPアドレスのリストをユーザに提供する場合。

他の理由でIPアドレスを取得する場合は、マルチホーミングとの互換性を十分配慮するようなプログラム設計をする必要があります。

IPアドレスによってふるまいが変わるようなサーバの場合はサーバのエチケットについてもお読み下さい。

リスト6 System Configurationフレームワークを使って、ローカルIPアドレスのリストを取得する

static void GetIPAddressListFromValue(const void *key,
                                      const void *value,
                                      void *context)
    // この関数はCFDictionaryApplyFunctionを呼び出した時に、
    // CopyIPAddressListSCFのコールバック関数として利用
    // されます。ネットワークサービスCFDictionaryから
    // IPv4のアドレスリストを抽出して、contextポインタで
    // 渡されるCFDictionaryに追加します。
{
    CFArrayRef intfAddrList;

    assert( key != NULL );
    assert( CFGetTypeID(key) == CFStringGetTypeID() );
    assert( value != NULL );
    assert( CFGetTypeID(value) == CFDictionaryGetTypeID() );
    assert( context != NULL );
    assert( CFGetTypeID(context) == CFArrayGetTypeID() );

    intfAddrList = CFDictionaryGetValue(value,
                            kSCPropNetIPv4Addresses);
    if (intfAddrList != NULL) {
        assert( CFGetTypeID(intfAddrList)
                == CFArrayGetTypeID() );
        CFArrayAppendArray(context,
                            intfAddrList,
                            CFRangeMake(0, CFArrayGetCount(intfAddrList))
                            );
    }
}

static OSStatus CopyIPAddressListSCF(CFArrayRef *addrList)
    // このシステムが持つすべてのIPv4アドレスを配列（CFArrary）として
    // 返します。アドレスの順序に意味はなく、確約されていません。また、
    // アドレスはCFString形式として返ってきます。
{
    OSStatus            err;
    SCDynamicStoreRef   ref;
    CFStringRef         pattern;
    CFArrayRef          patternList;
    CFDictionaryRef     valueDict;
    CFMutableArrayRef   result;

    assert( addrList != NULL);
    assert(*addrList == NULL);

    ref         = NULL;
    pattern     = NULL;
    patternList = NULL;
    valueDict   = NULL;
    result      = NULL;

    // ダイナミックストアに接続して、「検索パターン」を指定する。
    // ここで指定するパターン「State:/Network/Service/[^/]+/IPv4」は
    // IPv4項目をすべて取得するためのパターンです。

    ref = SCDynamicStoreCreate( NULL,
                                CFSTR("CopyIPAddressListSCF"),
                                NULL,
                                NULL);
    err = MoreSCError(ref);
    if (err == noErr) {
        pattern = SCDynamicStoreKeyCreateNetworkServiceEntity(
                                NULL,
                                kSCDynamicStoreDomainState,
                                kSCCompAnyRegex,
                                kSCEntNetIPv4);
        err = MoreSCError(pattern);
    }

    // SCDynamicStoreCopyMultipleを呼び出して、パターンリストを作る。
    // SCDynamicStoreCopyValueではなく、SCDynamicStoreCopyMultipleを
    // 使う理由は、この瞬間を「スナップショット」として納めて、現在の状況を
    // 正確に保存できるためです。

    if (err == noErr) {
        patternList = CFArrayCreate(NULL,
                                    (const void **) &pattern,
                                    1,
                                    &kCFTypeArrayCallBacks);
        err = CFQError(patternList);
    }
    if (err == noErr) {
        valueDict = SCDynamicStoreCopyMultiple(ref,
                                               NULL,
                                               patternList);
        err = MoreSCError(valueDict);
    }

    // IPv4項目については、IPアドレスのリストを抽出して、
    // 結果を配列に追加する。

    if (err == noErr) {
        result = CFArrayCreateMutable(NULL, 0,
                                      &kCFTypeArrayCallBacks);
        err = CFQError(result);
    }

    // 各アドレスを配列に追加する。

    if (err == noErr) {
        CFDictionaryApplyFunction(valueDict,
                                  GetIPAddressListFromValue,
                                  result);
    }

    // 後処理

    CFQRelease(ref);
    CFQRelease(pattern);
    CFQRelease(patternList);
    if (err != noErr && result != NULL) {
        CFQRelease(result);
        result = NULL;
    }
    *addrList = result;

    assert( (err == noErr) == (*addrList != NULL) );

    return err;
}

註:
2002年8月28日現在、Mac OS X 10.2のSystem ConfigurationフレームワークはIPv6インターフェイスの情報を管理しません。（r. 2944943）

リスト7 Open Transportを使って、ローカルIPアドレスのリストを取得する

typedef InetHost **InetHostHandle;

static OSStatus AddSecondaryAddresses(
                        InetInterfaceInfo* interfaceInfo,
                        SInt32 interfaceIndex,
                        InetHostHandle addrList)
{
    OSStatus err;
    InetHost *addrBuf;
    UInt32   addrCount;

    addrBuf = NULL;

    addrCount = interfaceInfo->fIPSecondaryCount;

    // 二次アドレス情報を受け取るためのバッファを用意。

    addrBuf = (InetHost *) NewPtr(addrCount * sizeof(InetHost));
    if (addrBuf == NULL) {
        err = kENOMEMErr;
    }

    // このインターフェイスの二次アドレスリストをOpen TransportにOTに
    // リクエストして、リストに加えます。

    if (err == noErr) {
        err = OTInetGetSecondaryAddresses(addrBuf,
                                          &addrCount,
                                          interfaceIndex);
    }
    if (err == noErr) {
        err = PtrAndHand(addrBuf,
                         (Handle) addrList,
                         addrCount * sizeof(InetHost));
    }

    // 後処理

    if (addrBuf != NULL) {
        DisposePtr( (Ptr) addrBuf );
    }

    return err;
}

enum
{
    kOTIPSingleLinkMultihomingVersion = 0x01300000
};

static OSStatus GetIPAddressListOT(InetHostHandle addrList)
{
    OSStatus            err;
    Boolean             haveIPSingleLinkMultihoming;
    NumVersionVariant   otVersion;
    SInt32              interfaceIndex;
    InetInterfaceInfo   info;
    Boolean             done;

    // システムタスク実行時であることが前提です。
    assert( TaskLevel() == 0 );

    SetHandleSize( (Handle) addrList, 0 );
    assert( MemError() == noErr );

    haveIPSingleLinkMultihoming =
        ( Gestalt(gestaltOpenTptVersions, (long *) &otVersion) == noErr
        && (otVersion.whole >= kOTIPSingleLinkMultihomingVersion )
        && ( OTInetGetSecondaryAddresses
                         != (void *) kUnresolvedCFragSymbolAddress));

    err = noErr;
    done = false;
    interfaceIndex = 0;
    do {
        done = ( OTInetGetInterfaceInfo(&info, interfaceIndex) != noErr );
        if ( ! done ) {

            // すべてのインターフェイスが使えない状態にあっても
            // Mac OS Xはデフォルトで、アドレスが「ゼロ」の
            // 単一インターフェイスを返しますので、その
            // インターフェイスはここで除外します。それ以外の
            // インターフェイスをはリストに追加します。

            if (info.fAddress != kOTAnyInetAddress) {
                err = PtrAndHand(&info.fAddress,
                                 (Handle) addrList,
                                 sizeof(InetHost));
            }

            // 二次アドレスを追加します。

            if (    err == noErr
                 && haveIPSingleLinkMultihoming
                 && info.fIPSecondaryCount > 0 ) {
                err = AddSecondaryAddresses(&info,
                                            interfaceIndex,
                                            addrList);
            }
            interfaceIndex += 1;
        }
    } while (err == noErr && !done);

    return err;
}

重要:
OTInetGetSecondaryAddressesはOpen Transport 1.3より前のバージョンでは実装されていません。Open Transport 1.3（Mac OS 8.1）より前のシステムとともにこのコードを正常に動作させるには、OpenTptInternetLibとの弱いリンクを行い、そのアドレスをkUnresolvedCFragSymbolAddressと比較して、それが存在するかどうかをチェックする必要があります。弱いリンクの詳細については、TN1083: Weak-Linking to a Code Fragment Manager-based Shared Libraryを参照してください。

リスト8 System Configurationフレームワークを使って、IPアドレス更新時に通知を受ける。

static OSStatus CreateIPAddressListChangeCallbackSCF(
                        SCDynamicStoreCallBack callback,
                        void *contextPtr,
                        SCDynamicStoreRef *storeRef,
                        CFRunLoopSourceRef *sourceRef)
    // SCFダイナミックストアへの参照と、関連するCFRunLoopソースを
    // 生成します。ここで作られたCFRunLoopソースを自分のrun loopに
    // 追加すると、IPアドレスリストが更新される度に、
    // 指定されたコールバック関数が呼ばれます。
{
    OSStatus                err;
    SCDynamicStoreContext   context = {0, NULL, NULL, NULL, NULL};
    SCDynamicStoreRef       ref;
    CFStringRef             pattern;
    CFArrayRef              patternList;
    CFRunLoopSourceRef      rls;

    assert(callback   != NULL);
    assert( storeRef  != NULL);
    assert(*storeRef  == NULL);
    assert( sourceRef != NULL);
    assert(*sourceRef == NULL);

    ref = NULL;
    pattern = NULL;
    patternList = NULL;
    rls = NULL;

    // ダイナミックストアに接続して、「検索パターン」を指定する。
    // ここで指定するパターン「State:/Network/Service/[^/]+/IPv4」は
    // IPv4項目をすべて取得するためのパターンです。

    context.info = contextPtr;
    ref = SCDynamicStoreCreate( NULL,
                                CFSTR("AddIPAddressListChangeCallbackSCF"),
                                callback,
                                &context);
    err = MoreSCError(ref);
    if (err == noErr) {
        pattern = SCDynamicStoreKeyCreateNetworkServiceEntity(
                                NULL,
                                kSCDynamicStoreDomainState,
                                kSCCompAnyRegex,
                                kSCEntNetIPv4);
        err = MoreSCError(pattern);
    }

    // 1つのパターンのみのパターンリストを作成し、このパターンリストに
    // 該当するキーを監視したいことをSCFに伝える。そして、CFRunLoopの
    // ソースを生成します。

    if (err == noErr) {
        patternList = CFArrayCreate(NULL,
                                    (const void **) &pattern, 1,
                                    &kCFTypeArrayCallBacks);
        err = CFQError(patternList);
    }
    if (err == noErr) {
        err = MoreSCErrorBoolean(
                SCDynamicStoreSetNotificationKeys(
                    ref,
                    NULL,
                    patternList)
              );
    }
    if (err == noErr) {
        rls = SCDynamicStoreCreateRunLoopSource(NULL, ref, 0);
        err = MoreSCError(rls);
    }

    // Clean up.

    CFQRelease(pattern);
    CFQRelease(patternList);
    if (err != noErr) {
        CFQRelease(ref);
        ref = NULL;
    }
    *storeRef = ref;
    *sourceRef = rls;

    assert( (err == noErr) == (*storeRef  != NULL) );
    assert( (err == noErr) == (*sourceRef != NULL) );

    return err;
}

註:
便乗的にネットワークを利用する場合は、長時間使用しないよう心掛けましょう。ネットワークトラフィックが発生しているかぎり、PPPの切断タイマーはリセットされず、ユーザが戸惑います。

ネットワーク経由のソフトウェアアップデート機能が良い例です。ソフトウェアアップデート機能は、ネットワーク接続のタイミンッグを見計らって、素早くソフトウェアアップデートの有無を確認します。しかし、ソフトウェアアップデートが存在する場合は、数メガバイトのファイルをダウンロードする前にユーザに通知をします。さもないと、予期しないタイミングでダウンロードのトラフィックが発生して、PPP接続の自動切断機能が働きません。

リスト9 System Configurationフレームワークを使って、ネットワークの確認を行う

static Boolean UnsolicitedAllowedSCF(const char *serverName)
{
    Boolean                     result;
    SCNetworkConnectionFlags    flags;

    // 注意:
    // CodeWarriorで正しくコンパイルするためには、
    // 「enums are always int」オプションを「オン」にします。
    // CWPro8のMach-Oひな形では、この設定が「オフ」になっています。

    assert(sizeof(SCNetworkConnectionFlags) == sizeof(int));

    result = false;
    if ( SCNetworkCheckReachabilityByName(serverName, &flags) ) {
        result =    !(flags & kSCNetworkFlagsConnectionRequired)
                 &&  (flags & kSCNetworkFlagsReachable);
    }
    return result;
}

リスト10 OTInetGetInterfaceInfoを使って、接続状況を確認する

static Boolean UnsolicitedAllowedTrad(const char *serverName)
{
    #pragma unused(serverName)
    InetInterfaceInfo info;

    return ( OTInetGetInterfaceInfo(&info,
             kDefaultInetInterface) == noErr );
}

リスト11 NSHTCPWillDialを使って、reachability（指定されたアドレスに辿り着けることができるかどうか）を確認します。

static Boolean UnsolicitedAllowedMNS(const char *serverName)
{
    #pragma unused(serverName)
    UInt32 willDial;

    return     (NSHTCPWillDial(&willDial) == noErr)
            && (willDial == kNSHTCPDialNo);
}

註:
TCP/IPスタックの生成方法の関係で、PPPリンクが接続されているにも関わらず、TCP/IPスタックがロードされていない場合があります。このような場合は、TCP/IPエンドポイントを開くのが安全であっても、NSHTCPWillDialはそのような結果を返しません。NSHTCPWillDialがこのような設計になっている理由は2つあります。

• この状況は珍しいケースです。PPPの設定でダイヤルオンデマンド機能を設定するユーザが多いので、このようなユーザはPPPリンクが接続されていることはTCP/IPスタックがロードされていることを意味します。
• PPPリンクの状況を確認するには、そのリンクに依存するコードが必要となります。良くあるリンク（ARA、FreePPP など）はコードを書けば済みますが、珍しいリンクや状況が把握しにくいリンク（AOLなど）をすべて対応することはほぼ不可能です。

NSHTCPWillDialは最悪でもfalse negativeを返すので、アルゴリズムが失敗する理由のうち、もっとも無難です。

注意:
インターフェイスが一時的に無効となること（例えば、一時的にAirMacネットワークの圏外に移動した場合や、ハブの接続ポートを変更した場合など）は沢山あるので、インターフェイスが無効となってから接続を終了するまでの間に、間隔を設けることが重要です。

リスト12 接続が無効となっているかどうかを確認する。

static Boolean IsEndpointStale(EndpointRef ep,
                               InetHostHandle addrList)
{
    Boolean     stale;
    InetAddress sourceAddr;
    ItemCount   index;
    ItemCount   count;

    if ( GetLocalIPAddressForConnectionOT(ep,
                                    &sourceAddr) != noErr ) {
        stale = true;
    } else {
        assert(sourceAddr.fAddressType == AF_INET);

        if (sourceAddr.fHost == kOTAnyInetAddress) {
            stale = false;
        } else {
            stale = true;
            count = GetHandleSize( (Handle) addrList ) / sizeof(InetHost);
            for (index = 0; index < count; index++) {
                if ( sourceAddr.fHost == (*addrList)[index] ) {
                    stale = false;
                    break;
                }
            }
        }
    }

    return stale;
}

static Boolean IsSocketStale(int sock, CFArrayRef addrList)
{
    Boolean         stale;
    struct in_addr  sourceAddr;
    CFStringRef     sourceAddrStr;

    sourceAddrStr = NULL;

    if ( GetLocalIPAddressForConnectionBSDSockets(
                                        sock,
                                        &sourceAddr) != 0 ) {
        stale = true;
    } else {
        if (sourceAddr.s_addr == INADDR_ANY) {
            stale = false;
        } else {
            stale = true;

            sourceAddrStr = CFStringCreateWithCString(
                                        NULL,
                                        inet_ntoa(sourceAddr),
                                        kCFStringEncodingASCII);
            if (sourceAddrStr != NULL) {
                stale = ! CFArrayContainsValue(
                                 addrList,
                                 CFRangeMake(0, CFArrayGetCount(addrList)),
                                 sourceAddrStr);
            }
        }
    }

    CFQRelease(sourceAddrStr);

    return stale;
}

注意:
従来のMac OSは以下で説明するように、ローカルIPアドレスリストが変更される度に、すべてのTCP/IPプロバイダを閉じることによって、不正な接続が残ろことを防いでいます。今日のMac OS Xはこのような制御をしないので、kOTProviderWillCloseやkOTProviderHasClosedメッセージをOpen Transportコールバック関数に送ることはありません。しかし、将来はMac OS XのOpen Transport互換性ライブラリにこのような機能が追加される可能性がありますので、このようなイベントに正しく対応しなければなりません。ほとんどの場合は、これらの2つのイベントを無視して、上記のように不正が接続が残らないような工夫をすれば十分なはずです。

註:
TCP/IPスタックは、「ディープスリープ」時のみにアンロードされます。これはPowerBook、Power Mac G4（AGP Graphics）以降、iMac DV以降で発生します。また、「ネットワーク管理者のアクセスによってスリープを解除する」オプションに対応するコンピュータの場合は、この設定が「入」であればスリープ時にTCP/IPスタックがアンロードされることはありません。

リスト13 プロバイダのクローズイベントの処理

static InetSvcRef gInetServices = kOTInvalidProviderRef;

static pascal void MyInetServicesNotifier(
        void* contextPtr,
        OTEventCode code,
        OTResult result,
        void* cookie)
{
    #pragma unused(contextPtr)
    #pragma unused(result)
    #pragma unused(cookie)
    switch (code) {
        case kOTSyncIdleEvent:
            // [... Yieldをするコードは外しました ...]
            break;

        case kOTProviderWillClose:
        case kOTProviderIsClosed:
            // OTはプロバイダをクローズしています。
            // 次に誰かがMyStringToAddressを呼び出すときにプロバイダを
            // 再オープンできるように、ここではプロバイダへの参照を削除します。
            (void) OTCloseProvider(gInetServices);
            gInetServices = kOTInvalidProviderRef;
            break;
        default:
            // 何もしません。
            break;
    }
}

static OSStatus MyOpenInetServices(void)
{
    OSStatus err;
    OSStatus junk;

    gInetServices = OTOpenInternetServicesInContext(
        kDefaultInternetServicesPath, 0, &err, NULL);
    if (err == noErr) {
        junk = OTSetBlocking(gInetServices);
        assert(junk == noErr);
        junk = OTSetSynchronous(gInetServices);
        assert(junk == noErr);
        junk = OTInstallNotifier(gInetServices,
            MyInetServicesNotifier, NULL);
        junk = OTUseSyncIdleEvents(gInetServices, true);
        assert(junk == noErr);
    }
    return err;
}

static OSStatus MyStringToAddress(const char *string,
        InetHost *address)
{
    OSStatus err;
    InetHostInfo hostInfo;

    // DNSプロバイダが現在オープンされていない場合はオープンします。

    err = noErr;
    if (gInetServices == kOTInvalidProviderRef) {
        err = MyOpenInetServices();
    }

    // ここではプロバイダを使って名前からアドレスへの変換を行います。

    if (err == noErr) {
        err = OTInetStringToAddress(gInetServices,
                 (char *) string, &hostInfo);
    }
    if (err == noErr) {
        // この例ではホストの1つ目のIPアドレスを取得します。
        *address = hostInfo.addrs[0];
    }
    return err;
}

重要:
Mac OS X 10.1〜10.1.4のバグにより、Classicプログラムと非Classicプログラム間のループバックは正常に動作しませんでした。Mac OS X 10.1.5やMac OS X 10.2以降では、Classicプログラムと非Classicプログラム間のループバックは正常に動作するようになりました。

MoreNetworkSetup（164K）

ダウンロード